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1. Introduction 


1.1. GENERAL 


This manual describes the job accounting system used with the SPERRY UNIVAC Operating System/4 (OS/4). 


The job accounting system provides the user with management information for computer center operation. 
information is provided on the basis of the individual job steps, with a summary printed for the entire job. This 
information includes items such as CPU time, size of the job’s main storage partition, elapsed time, and counts of 
EXCP macros issued to I/O devices. 


Use of this manual assumes knowledge of the OS/4 job control programmer reference, UP-7793 (current 
version), the OS/4 supervisor programmer reference, UP-7689 (current version), the OS/4 system generation 
programmer reference, UP-8213 (current version), and either the 9400/9480 systems OS/4 operations 
handbook, UP-7871 (current version), or the 90/60,70 systems operations handbook, UP-7937 (current version). 


The job accounting system is composed of two parts. The first part involves interfaces for supervisor counting 
and job control logging routines, which together capture the job accounting information in a SYSRES disc file. 


The second part is a utility routine (UTJAS) that can transfer the gathered information from the disc file to a 
printer or auxiliary disc or tape file. 


1.2. STATEMENT CONVENTIONS 
The conventions used to illustrate the control statements in this manual are: 


7 Capital letters and punctuation marks (except braces, brackets, and ellipses) are information that must be 
coded exactly as shown. 


a Lowercase letters and terms represent information that must be supplied by the programmer. 
a Information contained within braces represents necessary entries of which one must be chosen. 
2 Information contained within brackets represents optional entries that are included or omitted depending 


upon program requirements; braces within brackets signify that one of the entries must be chosen if that 
positional parameter is included. 


= An ellipsis (a series of three periods) indicates the omission of a variable number of entries. 
a Commas are required when positional parameters are omitted, except for trailing parameters. 
a Underscoring indicates the characters that may be typed in to abbreviate a command or command 


parameter; for example, AC ON may be typed in as the abbreviation of ACCOUNT ON. AC and ON are 
underscored to indicate this fact. 
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2. Generation Procedures 


2.1. GENERAL 


Each customer installation requires its own version of OS/4, whether a SPERRY UNIVAC 9400/9480 System or 
SPERRY UNIVAC 90/60,70 System. The process of tailoring and installing the operating system software is 
called system generation (SYSGEN). This includes tailoring the supervisor to reflect both the hardware and 
software features required by the installation. The job accounting system (JAS) is a software feature that may or 
may not be used at the installation. The OS/4 job accounting system can be made available by using the 
following procedures. At supervisor generation time, the job accounting system, with or without communications 
accounting, can be incorporated by specifying the JAS or JASM parameter on the SYSTEM macro instruction 
(2.2.1). The counting facilities of the supervisor may be further tailored by means of the ACCT macro instruction. 
In addition, a job accounting system file is created and initialized on the system resident disc (SYSRES). 


— 2.2. SUPERVISOR GENERATION 


Supervisor generation is the process of assembling a resident supervisor control routine. A series of required 
and optional macro instructions tailors the supervisor to the user's own specific requirements. These macro 
instructions are described in the OS/4 system generation programmer reference, UP-8213 (current version). 


2.2.1. SYSTEM Macro Instruction 


The SYSTEM macro instruction is required for Supervisor generation. The operand consists of a series of 
parameters that specify which features and options are to be included. Job accounting system is one of these 
optional! features and is included by specifying either JAS or JASM as a parameter on the SYSTEM macro call. 
The format that follows shows only JAS and JASM. For the complete SYSTEM macro format, see the OS/4 
system generation reference, UP-8213 (current version). 


Format: 





LABEL A OPERATION A OPERAND 







blank SYSTEM 






aerren 
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Parameters: 


JAS 
Indicates that job accounting capability is to be included in the system. 


JASM 
Indicates that job accounting plus communications accounting capabilities are to be included in the 
system. 


2.2.2. Job Accounting (ACCT) Macro Instruction 
The ACCT macro instruction is optional and may be supplied when the JAS or the JASM parameter is specified 
on the SYSTEM macro instruction at supervisor generation time. The ACCT macro instruction must follow the 


JOBS macro instruction in the supervisor generation source code. 


Format: 


A OPERATION A OPERAND 





Keyword Parameters: 


TRM=k 
Specifies the maximum number of line/terminal counters reserved in the resident supervisor. This 
operand is permitted only when the JASM parameter is specified on the SYSTEM macro instruction. 
The value for k must be greater than zero. 


LNE=m 
Specifies the maximum number of line counters reserved in the resident supervisor; accounting is to 
be performed by line only. This operand is permitted only when the JASM parameter is specified on 
the SYSTEM macro instruction. The value for m must be greater than zero. 


NOTE: 


If insufficient space is specified for JASM, some job accounting data may be lost. Line/terminal {L/T) 
counters are dynamically assigned and released as jobs acquire and release lines. Because the default 
value may not be adequate for most users, it is recommended that the LNE=m or TRM=k parameter be 
specified to tailor the number of L/T counters to the particular configuration and job mix. 


iOC=n 
Specifies the maximum number of |/O counters reserved in the resident supervisor. 


If both k and m are omitted, and the JASM parameter is specified on the SYSTEM macro instruction, m is 
assumed to be 4 (LNE=4) and job accounting is performed by line only. If n is omitted, |OC=n is computed 
by the job accounting system based on the number of physical unit blocks (PUBs) and the number of user 
jobs. 
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2.2.2.1. Line/Terminal Counters 


lf the TRM=k parameter is specified, the necessary accounting is performed by line and terminal. In this case, 
the value of k is the maximum number of lines and terminals that may be used by all jobs in the system during 
any one job step. 


Example: 


If there are two 1-step jobs running and three lines (each with three terminals) are used between the two 
jobs, TRM=24 should be specified. 


lf the LNE=m parameter is specified, the necessary accounting is performed by line only. In this case, the value 
of m is the maximum number of lines that may be used by all jobs in the system during any one job step. 


Example: 


If there are two 1-step jobs running and three lines are used between the two jobs, LNE=6 should be 
specified. 


lf there are not enough L/T counters for accounting a communications job, a flag is set in the job counter. This 
flag is later passed to the SYSJACNT record and finally to the auxiliary records for the job. The job accounting 
system utility routine (UTJAS) recognizes this condition and prints an L in the flag column to indicate incomplete 
L/T accounting data for that job step. To provide additional L/T accounting, the user must reassemble the 
supervisor. 


2.2.2.2. Manual Computation of 1/O Counters 


The number of I/O counters required may be computed by determining the maximum number of devices that 
can be allocated to all problem programs running concurrently in the system. One |/O counter must be included 
for each device used except for the console and incremental printer (90/60,70 systems only), SYSRES disc, and 
any handler device. One counter must be added for each instance that a sharable device is allocated to a second 
or subsequent job. Another counter must be added for each printer in the system. The formula for computing the 
lOC parameter value is: 


Ss 
lOC=(p—h-1)+et+ DS) (x, -1) 


i=1 
where: 

p a 
Is the number of PUBs in the system, excluding the console and incremental printer (90/60,70 
systems only). 

h 
Is the number of 1004/1005 or 9200/9300 handlers: 
0 No handler in the system. 
1 One handler. 
2 Dual handler. 

S 


Is the maximum number of devices which can be shared at one time (excluding SYSRES). 
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Is the number of jobs that may allocate the particular device concurrently. Ss 


Is the number of printers in the system. 


Example: 


For a system with 16 PUBs (15 + 1 console) including 2 printers, no handler, and 6 discs with only 2 discs 
being shared by any one of the 5 user jobs: 


2 

lOC= (15-O-1)+2+ > (5-1) 
i=1 
=(15-O0-1)+2+(4+4) 


=14+2+8=24 


2.2.2.3. System Computation of 1/O Counters 


If the IOC parameter is omitted, the number of |/O counters is automatically computed by the job accounting 
system, based on the assumptions that: 


1. only discs are sharable, and 
2. all discs are sharable at all times by all user jobs. 
With these assumptions, the formula for computing the IOC parameter value n becomes: 


IOC = (p—h—1)+e+ (ij —1)* (d — 1)) 


where: 
p 
Is the number of PUBs in the system, excluding the console and incremental printer (90/60, 70 
systems only). 
h 
Is the number of 1004/1005 or 9200/9300 handlers: 
0 No handler in the system. 
1 One handler. 
2 Dual handler. 
J 
ls the number of user jobs specified as parameter 2 on the JOBS macro instruction. 
d 
Is the number of disc PUBs in the system. 
e 


ls the number of printer PUBs in the system. 
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Example: 


For a system with 16 PUBs (15 + 1 console) including 6 discs, 2 printers, no handler, and 5 user jobs: 
loc = (15 —O—1)+2+ ((5 —1)*(6—1)) = 36 


|/O counters are dynamically assigned and released as job control allocates and releases devices. The value 
computed automatically is general and thus is artificially high for most users. Therefore, it is best to specify the 
{OC=n parameter on the ACCT macro instruction so that the !/O counter assignment is tailored to the particular 
configuration and job mix. 


If there are not enough I/O counters for a specific job step at execution time, a flag is set in the job counter. This 
flag is later passed on to the SYSJACNT record and finally to the auxiliary record for the step. UTJAS recognizes 
this condition and prints an | in the flag to indicate incomplete |/O accounting data for that step. The user can 
then choose either to rerun the job when additional |/O counters are available, perhaps in a different job mix, or 
to reassemble the supervisor, providing additional |/O counters. 


2.2.2.4. Associated Options and Restrictions 


a When either JAS or JASM parameter is specified, the SIMDAY parameter must also be specified on the 
SYSTEM macro instruction. 


a When the JASM parameter is specified without specifying the MCP parameter, the JAS parameter is 
assumed. Therefore, since the system will have no communications capability, no accounting for 
communications will be generated. 


a lf both JASM and JAS parameters are specified, the JAS parameter is assumed. 


z The JAS and JASM parameters are incompatible with the MINS or MINIO parameters on the SYSTEM 
macro instruction. If a combination of both parameters is specified, JAS and JASM are ignored and no job 
accounting is performed (9400/9480 systems only). 


a The MMCP and the JASM parameters on the SYSTEM macro instruction are incompatible. When both are 
specified, the JAS parameter is assumed and the system will have no accounting capability for 
communications activity. 


a A supervisor generation specifying the MCP and JAS parameters is possible. However, MCP message data 
will not be accounted. 


2.3. JOB ACCOUNTING FILE GENERATION 


The job accounting system writes the job accounting information to the system file on the SYSRES disc volume. 
The file name must be $YSJACNT, and the file must begin and end on a cylinder boundary on SYSRES. 


Disc space for the $SYSJACNT file may be allocated by the disc space management utility routine (UTDSM), or by 
job control with a set of device assignment statements in a control stream. This is done by using either a JAS 
supervisor with the accounting mode inactive or a supervisor with no JAS included. The file must be initialized 
with the INIT response to the SV30 message (3.1.1) when booting the JAS supervisor, or initialized with the 
UTJAS utility routine (Section 4). 
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Following is an example of a job control stream that might be used to generate the $Y$JACNT file. 


LABEL AOPERATIONA OPERAND A 
16 


The job accounting system outputs the accounting information to the SY$JACNT file as one record or as several 
records per job step, depending on the number of |/O and L/T counters assigned. One record is output tf the job 
step uses no more than 29 counters (1/O counters and L/T counters). If from 30 through 77 counters are used, 
two SYSJACNT records per job step are output. Thereafter, each additional 46 counters results in an additional 
record. 


The $YSJACNT file record capacity per cylinder is shown in Table 2—1. 


Table 2—1. Number of Text Records per Cylinder 


Records/ Cylinder 
Disc Subsystem 
First Cylinder* | 2—n Cylinders 


8411 63 70 


8414,8424,8425 253 260 





*The first seven records of the first cylinder are used for index records. 


Example: 
lf a user processes an average of 390 job steps per day, and the maximum number of devices assigned in 
any step is 29, then a daily operation would consume approximately 1.5 cylinders of an 8425 SYSRES 
SYSJACNT file. An 8-cylinder SYSJACNT file would have a capacity for about 5 days accounting data. 
2.4. AUXILIARY FILE GENERATION 
A major function of the OS/4 job accounting system utility program UTJAS is to transfer accounting information 
to an auxiliary tape or disc file, where it may be accessed by, for example, user-written accounting, billing, and 
Statistical programs. 
Tape auxiliary files have standard labels and are block numbered. 
Disc auxiliary files have sequential (SAM) organization. 
Auxiliary file records (tape or disc) are variable in length, with a maximum record size of 615 bytes. Because 


record size depends on the number of I/O device or line/terminal counters assigned to a job, the amount of file 
space required cannot be accurately specified. 
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3. Operation 


3.1. GENERAL 


The OS/4 job accounting system is activated by either of two methods, both of which are input via the console 
keyboard. 


a Reply to a supervisor message. 
a Type in an operator command. 
The first action occurs during system initialization. The operator command may be used when response to the 


Supervisor message was negative; it may also occur if the system has to be reinitialized because of an 
unrecoverable error on the system accounting file. 


3.1.1. Supervisor Message Display 


At supervisor initialization (boot) time, the decision must be made whether or not to activate the job accounting 
function. The following message is displayed on the system console: | 


SV30 ACTIVATE JOB ACCOUNTING? ANS. INIT,Y,N 
lf the response is INIT, the $YSJACNT file area is initialized and the job accounting mode is set to active. 
NOTE: 


The SYSJACNT initialization routine is not activated until the first RUN command is issued to the system. Then, if 
the SYSJACNT file space has never been initialized, or if an unrecoverable disc error has occurred since the last 
initialization, the routine format-writes the entire file area, resulting in a momentary time delay. If, however, no 
disc error has occurred since the fast initialization, the routine performats only the seven index records and the 
first data record. 


lf the response is Y, the job accounting mode is set to active and accounting information is written commencing 
with the first free record in the SYSJACNT file. 


If the response is N, the job accounting mode remains inactive until the ACCOUNT ON operator command is 
typed in setting the mode to active. 


If an error situation occurs in connection with the SYSJACNT file, job accounting is not activated and any 
subsequent ACCOUNT ON operator commands are not accepted. 


PAGE 
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3.1.2. ACCOUNT Operator Command 


Se 
The ACCOUNT operator command its available to systems that include job accounting capabilities. It is used to 
activate the job accounting function for all jobs that are initiated following the issuance of this command. 
Format: 
ACCOUNT ON 
Positional Parameter 1: 
ON 
Specifies that the job accounting mode is to be changed from inactive to active. Accounting will be 
performed for all jobs that are initiated after AC ON ts typed in. 
This command may be entered when the response to the SV30 message at system initialization was N or when 
the SYSJACNT file has been intialized by the UTJAS routine. 
This command may be entered as part of the recovery procedure for the JA32 message indicating that the 
SYSJACNT file area is full. The file should be dumped to the auxiliary tape or disc, after which the file is 
compressed. AC ON may then be typed in. 
3.1.3. ACCT Job Control Statement 
This optional statement enables the user to insert up to three unique control fields into the accounting records 
for the job. There may be only one ACCT statement in a control stream. This statement, if used, must be located 
in the first job step. No embedded blanks are allowed in any parameter. Tate 


Format: 







A OPERATION A OPERAND 


//AACCT [account-code] [,project-code] [,account-name] 


Positional Parameter 1: 


account-code 
Is an 8-character code identifying the account. If fewer than eight characters are given, the account 
code is right-justified and padded with blanks. 


Positional Parameter 2: 
project-code 
ls an 8-character code identifying the project. !f fewer than eight characters are given, the project 
code is right-justified and padded with blanks. 
Positional Parameter 3: 
account-name 


Is a 10-character code naming the account. If fewer than 10 character are given, the name is right- eco 
justified and padded with blanks. 
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LABEL AOPERATIONA OPERAND A 


AC lag la ore Ji. Are 4 


3.2. INACTIVE ACCOUNTING MODE 


Job accounting does not output any accounting information while in the inactive mode. The following error 
conditions inhibit the active accounting mode; the action that may be taken to correct the error is described. 
These error conditions are associated with one or more error messages. For the 9400/9480 systems, see the 
OS/4 operations handbook, UP-7871 (current version); or, for the 90/60,70 systems see the OS/4 operations 
handbook, UP-7937 (current version), for an explanation of these messages. 


a There is no $YSJACNT file on the SYSRES volume (JA12, JA33). 


1. 


2. 


3: 


Allocate the $YSJACNT file with the disc space management utility routine or with job contro! 
statement in the UTJAS control stream. 


Execute the initialize function of the UTJAS utility routine. 


Type in the ACCOUNT ON operator command. 


a The SYSJACNT file is not on a cylinder boundary (JA13, JA34). 


1. 


Z. 


3. 


4, 


Scratch the $YSJACNT file with the disc space management utility routine. 
Allocate the $YSJACNT. 
Execute the initialize function of the UTJAS utility routine. 


Type in the ACCOUNT ON operator command. 


s The $YSJACNT file is not initialized (JA11, JA12). 


This may be done in one of two ways: 


1. 


2. 


Execute the initialize function of the UTJAS utility routine and type in the ACCOUNT ON operator 
command. 


Respond with INIT to the SV30 message after rebooting the supervisor. 


@ An 1/0 error has occurred on the $Y$JACNT file (JA11, JA23, JA35, JA36, JA51). 


1. 


2. 


Transfer the accounting information to the auxiliary file with the UTJAS utility routine. 
Initialize the SYSJACNT file with the UTJAS utility routine. 


Type in the ACCOUNT ON operator command. 
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There is no space in the SYSJACNT file (JAO1, JA32). 


The job accounting logging routine displays a warning message on the console when accounting 
information is written as the first record of each track of the last cylinder. This console message has the 


format: 


JAO1 RESIDUAL TRACK = xx ON SYSJACNT WARNING 
where 


XX 
Is the number of the residual tracks in decimal. 


When this message is displayed, the operator is made aware that the $SYSJACNT file is nearing capacity, at 
which time job accounting would be deactivated. To prevent this, the operator must execute the UTJAS 
utility routine to transfer the information to an auxiliary file and compress the SYSJACNT file. Job 


accounting may then continue in the active accounting mode. 


If the JAOQ1 message is ignored, when the $YSJACNT file space is exhausted, the following message 
appears: 


JA32 JAS TERM ALL JOBS, NO SPACE ON SYSJACNT 
Accounting is automatically deactivated. 


1, Transfer the accounting information to the auxiliary file and compress the $YSJACNT file with the 
UTJAS utility routine. 


2. Type in ACCOUNT ON operator command. 
No system date given (JA31). 


When the response to the SV60O initialization message was NONE and the SET DATE operator command 
has not been issued: 


1. | Type in the SET DATE operator command (Julian date, parameter 3, is required). 

2. Type in the ACCOUNT ON operator command. 

Current initial number entry not available (JA22). 

The initial number entry precedes the job number and has a maximum value of 255. When the initial 
number is incremented, the JAS program checks whether or not job data remains on the SYSJACNT file 
with the same initial number as the current initial number. If it does, accounting is deactivated so that no 
newly initiated job will be accounted. However, the jobs running that have different initial number from the 


current initial number continue in the active accounting mode. 


1. Transfer the accounting information to an auxiliary file and compress the SYSJACNT file with the 
UTJAS utility routine. 


2. Type in the ACCOUNT ON operator command to effect accounting for newly initiated jobs. 

An |/O error occurred on the control block file (JA21). 

Job control writes the accounting information for a job step in that job’s control block file. When an I/O 
error occurs on the control block file, the job is switched to the inactive mode. No further accounting is 


done for that job. However, the system job accounting function remains in the active mode for other 
existing and newly initiated jobs. 
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4. Job Accounting System Utility Routine 


4.1. INTRODUCTION 


The SPERRY UNIVAC Operating System/4 (OS/4) job accounting system utility routine (UTJAS) provides the 
basic functions to initialize, maintain, and display the job accounting system file (SYSJACNT) on the SYSRES 
disc. With few restrictions, all functions of UTJAS can be performed on the $YSJACNT file, whether it resides on 
the SYSRES device or on a systems disc pack being used as a data disc. 


The initialization function uses the system-generated JAS transient routines $Y$T7800 through SY$T7803 and 
preformats the entire file, thus destroying any previous data on that file. For the user’s protection, UTJAS 
initializes (preformats) a SYSJACNT file on the SYSRES device only when the JAS mode is inactive. 

AS a maintenance function, UTJAS makes space available by transferring the data to an auxiliary file. If this 
transfer is made while the JAS mode is active, all data belonging to active jobs remains on the SYSJACNT file. 
When the transfer is completed, the remaining data is automatically compressed toward the front end of the file. 
The data on the auxiliary file may be used as input to a user-written program that produces cost-distribution, 
billing, control, or information reports. 

As a display function, UTJAS provides two levels of information. A list of the jobs contained in the file is 
produced, along with limited associated data, or all accounted data is printed for each job step and totaled by job. 
4.2. STRUCTURE, FUNCTIONS, AND OPERATING ENVIRONMENT 

The UTJAS utility routine consists of a resident routine and nine overlays. The program requires 20K bytes of 
storage capacity and operates with any tape subsystem, disc subsystem, printer, or console printer Supported by 
OS/4. The minimum requirement is one disc, one printer, and one console printer. 

The resident portion of UTJAS, the root phase (phase O), is made up of control routines and the DTF modules for 
the devices required by the utility routine. Overlay phases are read, as required, into an area of main storage 


immediately following the resident portion. The current phase overlays the preceding phase. 


The phase numbering has no relation to the sequence in which it is called. 


4.2.1. Phase 0, Root Phase 
Phase O has the name UTJASOO0 and is the resident portion of UTJAS. Phase O consists of the following: 
2 A routine that controls and provides access to the various overlay phases 


a The control and I/O routines used by other phases in accessing the SYSJACNT file 
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a Input and output DTFSD modules, input and output DTFMT modules, and DTFPR module 


2 A routine that writes diagnostic messages to the printer and/or the console 
a An interface table that serves as the communications link between the overlay phases 


If control is being passed to phase 9 because of a program, except for a program check in phase 3, phase O will 
SNAP the program partition before calling in the phase 9 overlay. 


4.2.2. Phase 1, Initial Routine 
Phase 1 has the name UTJASOO1 and consists of the following four functions: 


# The interface table is initialized with data from the system information block and file control blocks of 
assigned files. The status of SYSJACNT is verified; and SYSPOOL space is acquired as needed. 


) After fulfilling one parameter request and before reading parameter data for the next function, phase 1 
reinitializes switches and data fields set by the preceding parameter input and phase execution. 


a Parameter input is processed, the required files are opened, and routines are set up to accomplish the 
requested functions. If the parameter data is valid, the information is set in the interface table and control 
is passed to phase O, at which time the required phase is loaded. 


a If the dump routine has been requested for a $YSJACNT file residing on SYSRES and the accounting mode 
is active, phase 1 constructs a table containing initial number and job number of each currently running 
job. It also saves the current $SYSJACNT disc addresses used by the supervisor accounting routines. This 
allows accounting to continue during the dump and compress process, which refers to the table to 
determine whether an accounting record should be dumped to auxiliary file or retained on the compressed 
file. 


4.2.3. Phase 2, Initialize SYSJACNT File 


Phase 2 has the name UTJASOO2 and calls in the $Y$T7800 through $Y$T7803 transient routines to initialize 
the $YSJACNT file area with a format write (preformats the area). 


4.2.4. Phase 3, Compress SYSJACNT File 


Phase 3 has the name UTJASOO3 and is unconditionally executed following the phase 5 dump function if no 
errors occurred. If errors were detected, not resulting in termination, UTJAS provides the user with the option to 
compress the file or cance! the job without compressing the SYSJACNT file. The compress routine makes space 
that was occupied by the dumped jobs available for logging new data. Phase 3 collects all records not dumped 
and rewrites them in the newly available space toward the beginning of the $SYSJACNT file area. it also updates 
the SYSJACNT index records and the current SYSJACNT FILE disc address in the supervisor accounting routine. 


Any unrecoverable errors on the $YSJACNT file during the compress function result in cancellation of the job 
and also of the system job accounting function if the latter is active. The partially compressed SYSJACNT file is 
of questionable value and should be reinitialized or defined on a new area or on a different volume. 


If a program check occurs during phase 3 processing, phase 3 regains control, takes a SNAP of the program 
partition, deactives the system job accounting function, and then passes control to phase 9. 
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4.2.5. Phase 4, Sort Routine 


Phase 4 has the name UTJASO04 and is executed for all input uses of the SYSJACNT file except the list index 
routine (LI parameter specified on the PARAM statement). 


In a multijobbing environment, the accounting data of the various jobs is interspersed on the $YSJACNT file. 
Therefore, the OS/4 sort/merge routine is used to reorder each job’s data for chronological output to a printer or 
an auxiliary file. lf a dump function is being performed, then only data for jobs that were terminated prior to the 
initiation of this function will be transferred to the sort routine and ultimately to the auxiliary file. This is 
accomplished by reading the SYSJACNT file sequentially and checking each record against the running job table 
constructed by phase 1. 


if an entry for the job is found in the table, the record is bypassed. Then, the next sequential SYSJACNT record is 
read. Each record is checked against the running job table until: 


is the SYSJACNT disc address equals that saved by phase 1; 
= the $YSJACNT disc address equals that supplied on a CCCHHR= parameter; or 
a the end of the data record is encountered. 


If the dump function is executed for a SYSJACNT file not on the SYSRES device, then the entire SYSJACNT data 
area is acceptable to the sort and is ultimately dumped to the auxiliary file. 


If the PR parameter is specified on the PARAM statement, the entire SYSJACNT file data area is acceptable to 
the sort and ultimately to the print routine in phase 5. 


For each $YSJACNT record not bypassed, the following information is passed to the sort routine: 


Job logging date (ydd) 

Job start time 

Initial number 

Job number 

Step number 

Sequence number 

Disc address (cchhr) of the record in the $SYSJACNT file 


After all $YSJACNT input has been processed, control is passed to UTDSM routine; a delay should be expected 
while the sort is executed. 


When the sort routine (phase 4) terminates, the sorted information is retrieved; the 5-byte cchhr portion of the 
record is blocked 89 per record, and written to the SYSPOOL space acquired in phase 1 in standard 446-byte 
blocks to be used by phase 5. 
4.2.6. Phase 5, Copy/Dump/Print SYSJACNT File 
Phase 5 has the name UTJASO05 and consists of the following functions: 
a Copy Function 

The copy function reads the alternate library (ALTLIB) file and writes it to the output library (LIBOUT) file 


until an end of file (EOF) is reached on ALTLIB. This function begins with a message to inform the operator 
of the program's progress. 
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e Dump Function 
The dump function transfers from LIBIN to an auxiliary tape or disc file all accounting data for jobs that 
were terminated prior to the initiation of this function. All jobs running or initiated after the dump function 
began are passed over, and control is passed to phase 3 when the dump function terminates. This function 
begins with a message to inform the operator of the program's progress. 
The dump function reads a block of sorted record addresses, unblocks the record, and randomly reads the 
SYSJACNT file according to the sorted addresses. Each SYSJACNT record retrieved is converted to auxiliary 
record format and placed in the auxiliary record buffer. When the buffer is full, the records are dumped to 
the printer, an auxiliary tape or disc file, or both. At completion of the dump function, the LIBOUT file is 
closed. 

al Print Function 
The print function prints and totals the data from the auxiliary buffer. 

4.2.7. Phase 6, Print the Auxiliary File 

Phase 6 has the name UTJASOO6. It reads the auxiliary library input file and passes control to a subroutine that 

prints the record. This is the same print subroutine used by phase 5. 

4.2.8. Phase 7, List SYSJACNT File — Index Format 

Phase 7 has the name UTJASOO7 and reads the $YSJACNT file sequentially on the library input file (LIBIN). 

Using the first record of each job (step #1, sequence #1), it outputs limited information to the printer file. Sat ey 


4.2.9. Phase 8, List Auxiliary File — Index Format 


Phase 8 has the name UTJASO08 and reads the auxiliary input library file. Using the first record of each job (step 
#1, sequence #1), it outputs limited information to the printer file. 


4.2.10. Phase 9, End-of-Job Routine 
Phase 9 has the name UTJASOOQ. 
lf SYSPOOL space was used, the space is returned to the system. 


If the SYSJACNT file has been defined as an input or output library file, the amount of available space remaining 
on the SYSJACNT file is calculated. This calculated value is output to a printer or to the system console if there is 
no printer. 


The EOQJ macro instruction is issued for normal termination. The CANCEL macro is executed as indicated in 
either the 9400/9480 systems operations handbook, UP-7871 (current version) or the 90/60,70 systems 
operations handbook, UP-7937 (current version) where UTJAS error messages are described. In general, the 
CANCEL macro is executed when a program check occurs or when the user responds with a U to a UNxx UTJAS 
error message. 
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4.3. LOGICAL FILE DEFINITIONS 


All input and output files required by UTJAS must be defined in the control stream in accordance with job control 
specifications. 


Before a tape can be used as LIBOUT, it must be initialized with standard labels by the magnetic tape preparation 
routine, UTPREP; the block number parameter must be specified on the parameter statement. 


When an auxiliary tape or disc file is used as LIBIN or ALTLIB, the file must have been the output (LIBOUT) of a 
previous dump. 


The logical file names as specified on the LFD statements for UTJAS files are given in Table 4—1, together with 
an explanation of their proper use. 


The relationship of the function specified on the PARAM statement to the file definitions required in the control 


stream is shown in Table 4—2. 


Table 4—1. File Names for Logical File Definitions 


LIBIN Primary input file. Must by specified for all functions except ID. Depending on the functions requested, 
LIBIN may be: 
— $YSJACNT, whether on SYSRES or on a systems disc pack used as a data disc 
— Auxiliary tape 
— Auxiliary disc 
ALTLIB Secondary input file. ALTLIB may be used only when the CD or CP parameter is specified on the PARAM 
Statement or is input via the system console. ALTLIB may be: 
— Auxiliary tape 
— Auxiliary disc 
LIBOUT Output tape or disc file. LIBOUT is used with all functions except LI and PR. LIBOUT may be: 
— SYSJACNT, whether on SYSRES or on a systems disc pack used as a data disc, with ID parameter 
— Auxiliary tape 
— Auxiliary disc 


PRNTR Printer output file. The printer must always be defined via job control statements in the control stream. The 
hardware printer or COOP must be available for LI, PR, DP, and CP functions. The DU, 1D, and CD functions 
will execute without a printer, but one must be at least optionally assigned. 

NOTE: 
When an optional printer is not available, the DU, !D, and CD functions output an abbreviated prntr 
output to the systems console printer. 


DM01...08 SYSPOOL file or private work file required by sort/merge routine. (The file-id is $YSPOOL or any user ID.) 
or The file area must be large enough to sort either seventy 14-byte records per cylinder of SYSJACNT file 
PMO0O1...08 residing on a SPERRY UNIVAC 8411 Disc Subsystem or two hundred sixty 14-byte records per cylinder of 
SYSJACNT file residing on a SPERRY UNIVAC 8414, 8424, 8425 Disc Subsystem. A total of eight work files 

_may be defined. 
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Table 4—2. Relationship of PARAM Statement to LFD Statement 


LFD Filename 
DMO01...D0M08 or 
LIBIN ALTLI8& LIBOUT PRNTR 


Initialize | tnivaize SYSJACNT | Pretormass LIBOUT LIBOUT P- [- | $S$YSJACNT —-~ = 


SYSJACNT 
List—Index Format LIBIN to PRNTR Aux. disc Required 
Aux. tape 
$YSJACNT Required if 
P di 
LIBIN to PRNTR Aux. disc Required LIBIN=S$YSJACNT 
Aux. tape 





Dump LIBIN to LIBOUT $YSJACNT ee - a Optional | Required 
Aux. tape 
ALTLIB to LIBOUT Aux, disc Aux. disc 
Cony, Lume ars to LIBOUT } SYSJACNT eee a ae oat Pprional: | nequived 
LIBIN to LIBOUT Aux. disc : . 
p oomerin | fu to PRNTR \ $YSJACNT | it ss Required Required 


ALTLIB to LIBOUT Pea re Ke die 
CP Copy, Dump, Print LIBIN to LIBOUT $YSJACNT Pre a Nae . ; Required Required 
LIBIN to PRNTR oye a! 





4.4. PARAMETER STATEMENT 

The functions to be performed by the various phases of UTJAS are specified through parameters supplied either 
‘on PARAM statements in the control stream or on the systems console keyboard. Up to 10 parameters, 
separated by commas, may be submitted on the same PARAM statement or console transmission. (However, 
discretion should be used in doing this.) Parameters are processed in the order in which they are presented. Any 
excess beyond 10 parameters on a single card or console transmission is ignored. 


lf the PARAM statement is included in the contro! stream, UTJAS performs the requested functions. The end of 
parameter card input causes termination of UTJAS following completion of the final function requested. 


If no PARAM statement is included, UTJAS solicits input through the system console keyboard by issuing the 
message: 


UN10 ENTER PARAMETERS (CCCHHR=XXXXXxX,LI,PR,DU,DP,CD,CP,ID,EN) 
The operator replies by typing the appropriate parameters. 


Certain combinations of parameters are unadvisable, such as PR and DP (time-consuming use of the printer), or 
DU and CD (dumping LIBIN twice). 


The PARAM statement is included in the control stream immediately following the 7/ EXEC UTJAS statement. 


Format: 







A OPERATION A OPERAND 






iD 
[CCCHHRe=ccchhr] [LI] [,PR] [,DU] [.CD] ae, 


[,DP] [,CP] [,EN] 






//A PARAMA 
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Parameters: 


iD 


Initializes the SYSJACNT file by preformatting the required area on SYSRES or on a system disc pack 
used as a data disc. If the SYSJACNT file to be initialized is on the SYSRES device, the JAS mode 
must be inactive; also, following initialization, entries in the job accounting area of the Supervisor are 
updated to reflect the new status of the file. 


This parameter should not be specified in combination with any other parameter. 


CCCHHR=ccchhr 


Li 


PR 


DU 


CD 


DP 


Each time an accounting data record is added to the $SYSJACNT file, an end-of-data record is written 
in the next record position. Each subsequent data record overwrites the previous end-of-data record, 
and a new end-of-data record is written. When an unrecoverable I/O error occurs while writing to 
the $YSJACNT file, the end-of-data record is also compromised. JAS produces the error message: 


JA51 1/0 ERROR ON SYSJACNT CCCHHR=ccchhr 
where: 
ccchhr 
Is the disc ID of the unwritten end-of-data record. The system job accounting function is 
deactivated. 
The CCCHHR parameter is provided to enable the user to access the SYSJACNT file before taking 
corrective action described later. The CCCHHR=ccchhr is submitted exactly as displayed, followed by, 
for example, PR and DU. UTJAS uses the ccchhr in place of the $SYSJACNT end-of-data record. 
Once submitted, the CCCHHR= parameter remains in effect for the remainder of the job step. 
When the CCCHHR= parameter is used with a dump function, the $SYS$JACNT file is not compressed. 
To reactivate the job accounting function, the file must be reinitialized either by rebooting the system 


and responding with INIT to the SV30 message, or by using UTJAS to reinitialize the file and then 
keying in the ACCOUNT ON operator command. 


Lists library input file (LIBIN) in index format. The output consists of basic information, two jobs per 
print line. 


Prints the library input file (LIBIN). LIBIN may be the $YSJACNT file, either on SYSRES or a data disc, 
or it may be an auxiliary tape or disc output from a previous dump run. 


Dumps the LIBIN SYSJACNT file to LIBOUT. The accounting data for each (sorted chronologically) is 
written to auxiliary disc or tape file. 


Copies the auxiliary tape or disc input file (ALTLIB) to LIBOUT. (This is referred to as the copy 
function.) This is followed by the dump function which dumps LIBIN to LIBOUT. 


Dumps and prints the LIBIN $YSJACNT file. This is a combination of the DU and PR parameters. 
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CP , 
This is a combination of the copy, dump, and print functions. ALTLIB is copied to LIBOUT; the current 


LIBIN is dumped to LIBOUT; and the current LIBIN is printed. 


EN 
Indicates the end of parameter input. This parameter is required when input is via the system 


console. This parameter is not necessary with card input. 


Examples: 


LABEL AOPERATIONA OPERAND A 
1 


1 

A Param fur. | 

21 PARAM! (rp... | | 

5/AL PARAM [oicCHHIR|: OA 120. ,c:D 


ie Lists, in index format, the contents of the file identified as LIBIN. 
2. Format-writes (preformats) the index and text areas of the LIBOUT S$YSJACNT file. 


3. Copies ALTLIB to LIBOUT, then dumps LIBIN S$YSJACNT file to LIBOUT, using the ol a disc 
address instead of the EOF record. 


4.5. AUXILIARY TAPE/DISC FILE 


UTJAS uses the SPERRY UNIVAC OS/4 Data Management System to create the auxiliary tape or disc files. 
When defining the file with the DTFMT or DTFSD macro instruction, the record format is undefined 
(RCFM=UNDEF) and the maximum record size is 615 bytes (BKSZ=615). For auxiliary tape files, the blocks must 
be numbered (BKNO=YES). Each record in the job accounting auxiliary file consists of a standard area and from 


one to five other areas of varying lengths. 


4.5.1. Standard Area 


Every record in the auxiliary file has a 20-byte area that has the same format and similar contents as every other 
record in the file. The format of this area is shown in Figure 4—1. A brief description of each field in the record 


follows the figure. 


0 1 2 


Figure 4—1. Format of Standard Area 
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Field 

Bytes 0O—2 
Bytes 3—4 
Bytes 5—/7 
Bytes 8—9 
Bytes 10—11 
Bytes 12—13 
Bytes 14—15 
Bytes 16—17 
Bytes 18—19 
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Code 





EBCDIC 


EBCDIC 


EBCDIC 


EBCDIC 


Packed decimal 


Packed decimal 


Packed decimal 


Packed decimal 


Packed decimal 


4.5.2. Fixed-Length Area 


PAGE REVISION PAGE 


Description 
System initial number in effect when the job was initiated 
Job number as appears on the console log 


Job step number 


Sequence number, starting with 1, of the record for a given job 
step | 


Number of bytes in the fixed-length area (4.5.2). This fixed-length 
area is included in the first record of each job step. 


Number of |/O counters (4.5.3) included in the record 


Number of message (line/terminal) counters (4.5.4) included in 
the record 


Number of bytes in the fixed-length area containing job 
termination data (4.5.5) 


Number of job end I/O counters (4.5.6) included in the record. 
Only 1/0 counters that received data after job step termination 
until job termination are included. 


The first record of each job step includes a fixed-length area that contains information and statistics for that job 
step. The format of this area is shown in Figure 4—2. A brief description of each field in the record follows the 


figure. 


4-9 


8292 Rev. 1 SPERRY UNIVAC Operating System/4 4-10 


UP-NUMBER PAGE REVISION PAGE 





0 1 


4 log date 





12 main storage address 


16 | main storage size 


20} 
24 job name | 
; ae 





SZ program name 


36 


48 


52 
56 
60 


: 


72 restart disc filename 


40 account code 
44 
project code 





76 
80 job step start time 
84 
88 
92 communication region 
96 


100 


Figure 4—2. Format of Fixed-Length Area (Part 1 of 2) 
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0 1 2 3 
a 
a 
128 


‘132 reserved 


136 SCR factor 


152 job step end time 





reserved 


148 


156 
job step CPU time 


160 





164 phase counter 
168 transient counter 
172 

176 

180 OPR counter 


184 SYSRES counter 

188 SYSLST print counter 
192 | 
196 SYSLST skip counter 


200 SYSPCH counter 


Figure 4—2. Format of Fixed-Length Area (Part 2 of 2) 





8292 Rev. 1 


UP.NUMBER 


Field 





Bytes O—1 


Bytes 2—9 


Bytes 10—15 


Bytes 16—21 


Bytes 22—29 


Bytes 30—37 


Bytes 38—45 


Bytes 46—53 


Bytes 54—63 


Bytes 64—66 


Bytes 67—69 


Bytes 70—7/7 


Bytes 78—82 


Bytes 83—104 


Bytes 105—106 


Bytes 107—138 


Bytes 139—140 


Bytes 141—142 
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EBCDIC 


EBCDIC 


EBCDIC 


EBCDIC 


EBCDIC 


EBCDIC 


EBCDIC 


EBCDIC 


EBCDIC 


EBCDIC 


EBCDIC 


EBCDIC 


EBCDIC 


EBCDIC 


EBCDIC 


EBCDIC 


EBCDIC 


EBCDIC 
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Description 


Priority number as submitted on the JOB job control statement. 
The default value is 13. 


The date stored in SBSDTE when the job was initiated. The format 
iS XX/XX/XX. 


Low-order main storage location of the job, as it appeared in the 
JCO1 console message 


Number of bytes required by the job, as it appeared in the JCQ1 
message. This is calculated as follows: (JPSPAD + 12) — JPSPRE 
+ 1. 


Job name as it appears on the JOB job control statement 


Program name as it appears on the EXEC job control statement, 
left-justified and padded with EBCDIC zeros 


Account code as it appears on the ACCT job control statement, 
right-justified and padded with blanks 


Project code as it appears on the ACCT job control statement, 
right-justified and padded with blanks. 


Job accounting name as it appears on the ACCT job control 
statement, right-justified and padded with blanks 


Logical unit number as it appears on the RSTRT job control 
statement 


Record serial number as it appears on the RSTRT job control 
statement 


Disc file name as it appears on the RSTRT job control statement 


Job step start time in the format hh:mm, where hh = hour and mm 
= minute, taken from SBSTOD 


The EBCDIC representation of the hexadecimal contents of the 
job’‘s communication region. This requires two EBCDIC bytes for 
each hexadecimal! byte. 


The EBCDIC representation of the hexadecimal contents of the 
UPSI byte 


Option bytes. When content of byte is 1, the option is set for the 
job step. When content is O, the option is not set. 


Multiplicative factor for the scratch file allocation in SYSPOOL, as 
stored in JPSJDA 


Multiplicative factor for the MCL file allocation in SYSPOOL, as 
stored in JPSJDA 


4—12. 


8292 _ 


UP-NUMBER 


SPERRY UNIVAC Operating System/4 


PAGE REVISION PAGE 


Field 





Byte 143 


Byte 144 


Bytes 145—150 
Bytes 151—155 


Bytes 156—163 


Bytes 164—168 


Bytes 169—173 


Bytes 174—178 


Bytes 179—183 


Bytes 184—188 


Bytes 189—193 


Bytes 194—198 


Bytes 199—203 


Byte 204 


NOTE: 


Code 





EBCDIC 


EBCDIC 


EBCDIC 


EBCDIC 


Packed decimal 


Packed decimal 


Packed decimal 


Packed decimal 


Packed decimal! 


Packed decimal 


Packed decimal 


Packed decimal 


Packed decimal 


EBCDIC 


Description 


When set to 1, indicates that one or more I/O counters could not 
be assigned to allocated devices due to a shortage of counters 


When set to 1, indicates that one or more message counters could 
not be assigned due to a shortage of counters 


Reserved; initialized to EBCDIC zeros 
Job step end time, as stored in SBSTOD 


CPUT time used by the job step. This item is subdivided into four 2- 
byte packed decimal fields representing hours, minutes, seconds, 
and milliseconds, tn that order. 


A count of the number of attempts to load a phase for this job 


A count of the number of requests for transient routines issued for 
this job; includes EOJ, LOADER, and GETCS requests 


A count of the number of disc-buffered card images successfully 
retrieved via a GETCS macro or a COBOL ACCEPT verb by a user 
program. This includes // param cards, /S, /*, and data cards. 
A count of the number of OPRs issued for this job (OPRs issued by 
a user program, its transients, and job control) 


A count of the number of 1/O orders to SYSRES for this job 


A count of the number of EXCPs to SYSLST, excluding SKIP 
EXCPs, for this job 


A count of the number of SKIP EXCPs issued to SYSLST for this 
job 
A count of the number of EXCPs to SYSPCH for this job 


Termination status: 


Normal 

Cancel 

Dump 

Job control abort 


coun 2 


SBSxxx and JP$xxx labels are defined in Section 3 of the 9400/9480 systems OS/4 supervisor programmer 
reference, UP-7689 (current version) and 90/60,70 systems OS/4 supervisor programmer reference, UP-7934 


(current version). 
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4.5.3. 1/0 Counter Area 


This area, when present, contains information on the |/O counters allocated to the job. This area varies in length 
according to the number of counters assigned. If more I/O counters are assigned than can be contained in the 
first record for the job step, additional records are written. |[/O counters that contain zero counts represent 
devices allocated but not used during the job step. Each !/O counter has the format shown in Figure 4—3. A 
brief description of each field in the record follows the figure. 









0 1 2 


Figure 4—3. 1/0 Counter Area 





Field Code Description 








Bytes O—2 EBCDIC Device identification 
Byte 3 EBCDIC Reserved; initialized as X‘40’ 


Bytes 4—8 Packed decimal A count of the number of EXCPs to the device attempted by a user 
program, its called transients, and job control 


| 4.5.4. Message Counter Area 


This area, when present, contains information on the message (line/terminal) counters allocated to the job. This 
area varies in length according to the number of counters assigned. If more message Counters are assigned than 
can be contained itn one record, additional records are written. The format of the message counter is shown in 
Figure 4—4. A brief description of each field in the record follows the figure. 






0 1 | 2 3 


Figure 4—4. Message Counter Area 











Field Code Description 
Bytes 0O—3 EBCDIC Line/terminal name or identification as supplied by the user at 


MCP generation time 


Bytes 4—6 Packed decimal A count of the number of messages from the terminal to the 
processor | 
Bytes 7—9 Packed decimal A count of the number of messages from the processor to the 


terminal 
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4.5.5. Job Termination Data Area 


This area, when present, contains data concerning activity on behalf of a job from the final job step termination 
to job termination. The format of the job termination data area is shown in Figure 4—5. A brief description of 
each field in the record follows the figure. 


job end time 


job end CPU time 


job end OPR count 


job end SYSRES count 





Figure 4—5. Job Termination Data Area 


Field Code Description 








Bytes O—4 EBCDIC Job end time, which has the format hh:mm, where hh = hours, 
and mm = minutes 


Bytes 5—12 Packed decimal CPU time used between the end of the final job step and job 
termination. This field is subdivided into four 2-byte packed 
decimal fields representing hours, minutes, seconds, and 
milliseconds, in that order. 


= ¢ 
eee” 


Bytes 13—17 Packed decimal A count of the number of OPRs issued for this job following 
termination of the final job step. 


Bytes 18—22 Packed decimal A count of the number of I/O orders to SYSRES for this job, 
following termination of the final job step. 


4.5.6. Job End 1/O Counters Area 


This area, when present, contains information on the |/O counters for any device that received |1/O EXCPs for 
this job, following termination of the final job step. Items such as TAKE ALL, MTC, and DUMP are accounted for 
in this area. These I/O counters are the same as those described in 4.5.3 with the format shown in Figure 4—3. 
Only !/O counters with nonzero count fields are included in this area. 


4.6. JOB CONTROL STREAM EXAMPLES 


Examples of control streams that may be used to execute UTJAS are given in the following paragraphs. If the 
PARAM statement is used, it must be placed in the control stream as shown in examples 1 through 4. If the 
parameters are to be entered via the system console, then the procedure is as shown in example 5. 
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4.6.1. Parameter Input via the PARAM Statement 


Example 1: 
LABEL AOPERATIONA OPERAND A 
1 10 16 
J. Jom . |b... | 


This example initializes the SYSJACNT file on LIBOUT. 
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Any of these statements 
May be. Js With HAS 
alls Sif Sp are alee 


CONTYO 


Pee! Se en = 


Example 4: 
LABEL AOPERATIONA OPERAND A 
1 10 16 
ARTs ae re 
LL SPTLaN MAN LDUMP., WeREAD 
AL Dic, lebrP | D, PRNITE 
AL Dvics | bio. | ViDIL, DSPBit 
YL eB. s| bvsTaclnT,DSP3i 8, 17 WED Lt Bt.N 
AL Pv. | bor, | AA. vie, SP..98 
AL Bits. | awxool |,.sPacio LED ALT LICE 
At OMe. | Bic, | Vic wo DSRS tei le lal 
A LBil., | dvs Poel. ,.D4APs1h Lap, DMat 
2.0 | Vis. wd, D 
bY SPOOL. ,D SPB! LED, DMOZ im 
Yl, DV | VA will. SP eT 
L BIL 2| SP A.ok.2, _ Wi bE D wo CBewt, 11 tii i 1 
AL ExiE<, | OAD SILT Pog REL 
i 
a 
a 
A 
i 
i 
i 
E 


| 
2 
pe ie eee oe ei eaten, aed 


rT we woe ft Cc . 
ak» # 
p 

( & 
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4.6.2. Parameter Input via System Console 
Example 5: 
LABEL AOPERATIONA OPERAND A 
10 16 
rib | ei | 
AL OPILON MAY CDUMP,, NORAD 
AL Dv. | io,P, | 4. FD, PRNTR 
A pia. | bio. | /, Midi, DA&tittil 
By by sca ln Dsu l / D, tT BIN 
AL Die. | loo... | ar, vio, SNP 0c 
LL Bie. | WoratigNPi ool, AA ED ALTLLB 
AL Die. | loiu,d. | Win Mol. SYRZOO 1) siti iit ii dy 
JL tBi..| bYSPowL BYRIZ00.. 1/4/, .LED, DMol 
LL Dv‘ . | lez, || DL, ANRBOO 
LBIL | bs eRwere ,IYR300 /, LIED, DMO’ = 
VAG tal te A tcc Ree ne eee pee we ew ewes 
y 6xuec. | bras LoarsutB REG tii li is lily 
Pere rer Lirers ci 


At execution time, UTJAS displays the following console message: 


nn ENTER PARAMETERS (CCCHHR=XXXXXX,LI,PR,DU,DP,CD,CP,ID,EN) 


Is the job number for 9400/9480, or is the message number for 9700. 


Any of the following responses are valid for use with this control stream. 


nnR LI® 

nnR DU® 

nnR PR® 

nnR DP® 

nnR CD® 

nnR CP © 

nnR CCCHHR=10A12C,DP © 
nnR LI,DU,ENS 
nnR LILCD,EN®S 
nnR CD,LILEN® 
nnR EN® 


If EN is not present in a parameter input transmission, UTJAS repeats the ENTER PARAMETERS message. The 
user may respond with additional parameters including EN. 





, Meee 


ene” 
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4.7. PRINTER OUTPUT 


There are four types of printer outputs: a heading page, a PRINT function output, an LI parameter output, and a 
UTJAS termination output. Each of these outputs is discussed in the following paragraphs. The abbreviations 
and terms that appear in these outputs are explained in Table 4—3. 


Abbreviation/Term 


ACCOUNT 


CHKPT NO. 


COMREG 
ELAPS 
FILE NAME 
FLAGS | 
FLAGS L 


i/O counters 


JJ 
LIBIN=xxxxxx 


Line/terminal counters 


LOG DATE yy/mm/dd 


MB 
MS 

NAME 
OPTIONS 

p 

PROJECT 
RESTART LUN 


S/M=xx/yy 





Table 4-3. Printout Abbreviations and Terms (Part 1 of 2) 


Explanation 
From // ACCT card, if used 


Record number of the restart record. If a 77 RSTRT card was not used for the job, this item is not 
printed. 


Communications region. lf its value is zero, the item is not printed. 

Elapse time: the difference between start and end time 

Disc checkpoint file name: printed when available 

Unavailable 1/O counter or counters 

Unavailable line/terminal counter or counters 

All |1/O counters assigned to the job step are printed. Zero counts indicate allocated devices that 
received no I/O activity. The format of the 1/O counters is: DVC ID=count. A pair of identical DVC IDs 
(example: EEO=868, EEO=17) represents the count of nonskip EXCPs and the count of skip EXCPs, 
respectively, to a printer. 

Job number 

Volume serial number of LIBIN storage device 

The format of the line/terminal counter is: NAME=x/y. NAME is the line or terminal identification 
assigned at MCP generation time; x is the count of messages from the device to the processor; y is 
the count of messages from the processor to the device. 

System date in effect when job data on printout was logged 

Memory base 

Memory size 

From // ACCT card, if used 

All options in effect for the job step are listed. 

Priority 

From // ACCT card, if used 

Restart logical unit number. If a 77 RESTART card was not used for the job, this item is not printed. 
S = scratch file 

xx = multiplicative factor for SCRATCH file allocation in SYSPOOL used by disc processors 

M = MCL file 

yy = multiplicative factor for MCL file allocation in SYSPOOL used by disc processors 


NOTE: 


For additional information relating to size determination factors, refer to the software 
conventions programmer reference, UP-7945 (current version), paragraph 5.2. 


4-19 
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Abbreviation/Term 


SSS 


Standard counters 


GCS=xx 


LSTL=xx 


LSTS=xx 


OPR=xx 


PCH=xx 


PHAS=xx 


RES=xxx 


TRAN=xx 


4.7.1. Heading Page 


SPERRY UNIVAC Operating System/4 4—20. 
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Table 4—3. Printout Abbreviations and Terms (Part 2 of 2) 





Explanation 
Step number 
Standard counters are allocated to every job step; if the count is zero, the item is not printed. 
Standard counter that indicates the number of disc-buffered card images successfully 
retrieved via GETCS by a user program, including // PARAM, /S, and /* statements 
Standard counter that indicates the number of EXCPs to SYSLST, exciuding SKIPs 
Standard counter that indicates the number of SKIP EXCPs to SYSLST 
Standard counter that indicates the number of OPR requests (user program, transients, and 
job control) 
Standard counter that indicates the number of EXCPs to SYSPCH 
Standard counter that indicates the number of attempts to load phases 
Standard counter that indicates the number of EXCPs to $YSRES 
Standard counter that indicates the number of requests for transients 
Termination status 
User program switch. If its value is zero, this item is not printed. 


When a printer is available, UTJAS outputs a heading page. An example of a header page is provided in Figure 


4—6. 


4.7.2. PRINT Function Output 


Because of the potentially voluminous printout that could result from a large SYSJACNT file and because of the 
varying amounts of data pertinent to individual jobs and job steps, the print output of the UTJAS has been 
designed with a free format. 


Two examples of printer outputs for the PRINT function are provided in Figure 4—7. 


4.7.3. Ll Parameter Output 


An example of a printer output for the LI parameter is provided in Figure 4—8. 


CG) UN VAC 996079070 OS/4 19.90 JOB ACCOUNTING UTILITY 75/12/08 14%41 SUPERVISOR Y2 Ineo! voB 14 CP1548 


YAaGWNNN-dn 
| “AH Z6ZB_ 


LIBIN 051548 SYSJACNT 
@ < acriia oSP576 DAUKI 
LIBOUT  SPO4I16 TAPEDYI6 


@ ov PARAM LILCP 


UNxx 
UNxx 
Explanation: 


@ Heading line showing: 


— Machine type 

— Job accounting utility version number 
— System date 

— Time of day 

_ Supervisor identification 

— Job number 

— Job name 


Q) Volume serial number and file IDs of LIBIN, ALTLIB, and LiIBOUT, if assigned 


@) /{ PARAM (parameter card input). If parameter input is via console 
keyboard, this line is suppressed. 


” 
a) 
m 
av 
=) 
< 
Cc 
< 
< 
> 
) 
Oo 
cS 
® 
a 
> 
—¥ 
=) 
2 
g 
S 
f 


@ Diagnostic messages (UNxx), if any 
Figure 4—6. Example of Heading Page for Printer Output 


NOISIASY A5vd 





a) 95/4 JO8 ACCOUNTING UTILITY LOG DaTE 75/09724 INITIAL Noe 128 LIBIN. ® 051548 PAGE lu 
Q) JOBNAMe JJ 5SS PROGNAYS START END claps cPU TIMe 1S P Ma MS ACCOUNT = PROVECT NaMe FLAGS 
3) USERT4 11 1 VYSERTH99 17392 37808 nnind 993903003512 N 33 O2490uU OO2aD0 #£«%139625 302,12 ENG INEERNG L 6) 
@) alee ALTERS ALTERONDeMAVYIDUYPANOVOL SSYSDIMP PHAS#1 TRANSB QOPrell RESE122 GI2e14 LNES#S/y . 
Mé® 
TERMINATION AT 17295 , CPU TIME an:90320:052 OPRwl RESE17 
TOTALS: ELAPS 09:93 CPU TIME Nosddsno:56q4 PHASw] TRAN®H8 OPRBYQ2 VES#139 GF2F14 LNESES/y TRMOe5/4 
PRNTIS4S 12 1 UToOTP%9D 17206 137307 aAntai 90%00:03:949 N 13 924900 230%aRO0 2 B F 
S/Metsl PHaAS#!t TRAN#2 6C€S5Se82 OPRsh RESB25S5 EE0s869 EENF17 pease: Le Mier a, “Apacs : 
TERMINATION AT 17297 , CPU TIME 9927057903046 OPRel RES#14 
TOTALS: ELAPS nosso, CPY TIME 95:90:03°994 PHASS1 TRAN®2 GCS#2 OPRe7 RESE271 FE08868 EEOHI7 
PR1S48 13 1 UTYASIID 17209 17310 aatol oofooroFsels N $3 O24%n00 3906)00 200. 4 7 AYROLL 
S/MB1/1 PHAS#1] TRANEI6 GCS#2 OPReS RES8632 CEDR342 FED=22 ea Pree . a 
TERMINATION AT 17310 , CFU TIME 19200:299%0Su OPRel RES#16 
TOTALS: ELAPS Oo:01 CP TIME 9O3002N9:94q PHAS B11] TRANBI6 6CS*#2 OPReG RES"64R EED"8342 EEDB22 


Explanation: 
qa) First heading line (at top of page) showing: 
— Title: OS/4 JOB ACCOUNTING UTILITY 


— LOG DATE xx/xx/xx: System date in effect when job data that 
follows was logged 


— INITIAL NO, nnn: System initial number in effect when job data that 
follows was logged 


NOTE: 


When log date or initial number changes, a new page is started. 


— LIBIN=xxxxxx: Volume serial number of LIBIN storage device 


— PAGE number: Numbered sequentially from 1 for each parameter 
processed 


me © © @O 


Second heading line: Refer to Table 4—3 for an explanation of 
abbreviations used in this line. 


First data line: Contains data corresponding to items in second heading 
lines. 


Second, third, etc. data line of job step data: This is a free format area, the 
length of which corresponds to the amount of information to be printed. 


Flags: 

L Shortage of line/terminal counters: One or more lines/terminals were not 
accounted for this job. 

! Shortage if 1/O counters: One or more I/O devices were not accounted 


for this job. 


a. Example 1 


Figure 4—7. Examples of Printer Outputs for PRINT Function (Part 1 of 2) 


YAGWNONedN 


NOISIASRY ASVd 


L"AeY Z6ZB 


Y 
“v 
m 
mS) 
ms) 
~< 
Cc 
< 
< 
> 
© 
o) 
a] 
© 
a 
2. 
= 
© 
2 
o 
o 
3 
= 
& 





Y 


YY 


~—™ 


TOTALS! ELAPS ODo307 CPy TIME 99:01:243:583 PHASw31 TRAN 


KB1s!,679 

ASmMyJ3 16 1 LisyPp$39 18:38 18:49 nnaia2 oo3003! 
S/MB1/1] OPTIONS: MAYIDUMP,NOREADY PHAS#@13 TRAN 
b 2 DAS44I50 18340 18:44 anin4 of%0131 
7Mei71 OPTIONS: MAYLOUMP,NOREADY PHASR@IQ TRAN 
K§i21,230 


Explanation: 
First heading line: Same as example 1 


Second heading line: Refer to Table 4—3 for an explanation of 
abbreviations used in this tine. 


Data line of job step data: This line is a continuation of job step data from 
previous page (page 15). 


Other data lines of same job: Job name is not repeated if job has more than 
one step. 


me © © OBO 


Termination data line: Items shown on this line or lines represent data 
inctuded in the job termination data area of auxiliary accounting file record. 


G) OS/4 yOB ACCOUNTING UTILITY LOG DATE 75/30/01 INITIAL NOo 140 LIBIN » 051548 PAGE 14 
@) JOBNAME JJ SSS PROGNAME START END ELAPS cPU TIME TS ®° M3 MS aCCOUNT PROJECT NAME FLAGS 
8) S/Mmis] OPTIONS: MAYIDUMP,NOREADY PHAS#11 TRANSI14 6C58206 OPRa4 RES#27y) EEn®254 EEOs8B8 LAb#781 

15 2) «DAS#4999 0 «18333 18837 AninY 00:01:35:757 N43 

S/Meq/] OPTIONS: MAYTOUMP,NOREADY PHAS#10 TRANS24 GCSs OPRe3 RES#435 €E083,283 EEGs5SO LAb62989 YB4e2, 869 

K81#1,4678 
® 13 3. LISUPS30 %18:37 18:38 (Anint 909:309:01:455 y 13 

OMREG 1358°097990001039790N0 SysMe}/1 OPTIONS$ MAYIOUMP,NOREADY PHAS#In TRAN@13 GCSe7 OPRS3 RES#s7a EE0#24 

E€Qm4 LA6#270 JB422U Kei#0 
6 TERMINATION AT 18138 , CPU TIME nara0is0r116 OPRe2 RESe32 y84=2 KBIBl 
#51 6CSe217 OPRal2 RES#6iS EE083,561 EED8S2 LaeeZ2,040 184821691 
4:776 Nt2 OL12n00 vO%000 EX=<80U 205.A8C 125-=GRoOUP 
216 G6CS9207 OPRwe4 RES®274 EED® 242 EEOS7 Lab622,395 
42a0y N42 | 
24 6C58#3 QOPRad RES8435 EEO" 2,396 EEOs38 LAb2746 JB4a2, 292 


6) Totals line showing: 
= Elapsed time (time from start of job to job termination) 
— CPU time (time from start of job to job termination) 
. — Standard counters 
— 1/O counters 
— Line/terminal counters 
The totals include counts from all job steps, including the termination step. 


b. Example 2 


Figure 4—7. Examples of Printer Outputs for PRINT Function (Part 2 of 2) 


YASGWNN-dNn 


NOISIASY 3A9Vd 


4b AeY Z6Z8- 
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i 
NaME 
N 
L 
N 
C 
GROUP 


PAGE 
INE 
PAY 
GRA 
MAINTENANC 


PROJECT 
2 
? 
0 
j 
AeBe COOL 
20594¢3 DEVELOPMNT 
3 
s 
9] 
5 
6 


ACCOUNT 

| 
705225 
100¢2) 

5 

» 

5 

0 

e 


NOOTOODWNTO-~OTN® 
SNF MANN HO -MAMNo- 
OP 06 FO O66 9H OG CO OF CO HE OF OB 08 FE OO OO 
PANO ODS OD COGHD OD 
=a=em—OO0O0O 0 Ot 0 0 tte oe 


START 


ae oe err tre 2k | 
NNN OOoOooeacC0ce0e0Ccoo 
~~ ASS SS SS SS SS SS 
DO DOO wees cn tet 8 re et a ot 
~~ S SS ASS SH SS SS AS 
ASU LEV LTD oft FT AE et SD AFD UD FP Le Os OF 
Pr PR PS Pm 


LOG DATE 


xz = 

wv wy wy w 
Treoarr rarct-am™ wn 
-rrTeae af ih Jj 37 oa 
iNifiew=ss me wuUIhL DiWsDwyr Oo 
Weeee FOOD EOE SZ ZSW 
Oeei IO-<«€VENamnw a 
RVAATERKLTV2R?I<KCIVE IAD 


75/12/08 
JOB NAME 


HMOANORK TOD ONTOG-— 


oe eee ee on 8 re et ee YY et et ot ot oe fT ot 


ON 


NANMAMAAMAATITITITITT 


ee aed OE et 8 ot ot ot ok 8 oh nt 8 oh ot od 


(Refer to Table 4—3 for an explanation of abbreviations used in this line.) 


Data lines: Each data line consists of basic data for two jobs. 


Il1 Jd 


MaOe 


wwe Vvs8svo 
zZ—OozZ>D 2uzw 
—Ienoe xXQO—M 
UA: el: 4 were 
Zu rw w> « 
awd oa t z<«r 
CO-wN =a. 
UUEK>N TC) 
vaoo— z 
aa « lad 


@ Second heading line: Contains the items that are to be listed in the printout. 


NAME 


051548 
MALNTENANC 


Ooeao~su Nn 
NM —1 @ —~ of 
eo@ © og e2on™ 
Ano eo Ano 
oro--w oon 
mM Fr oO Or 

™ “e 


SYSJACNT 
PROJECT 
AeBe COOL 


OF 
Figure 4—8. Example of Printer Output for Li Parameter 


” 


LISTING 
ACCOUNT 
5 
§ 
: ) 

0 

td 

0 

0 

s 

! 
705.225 


~ O6OCR Oo TOK NING TT wD 
rorrTrTrTNno-MONMFTOO 
OF COCO O26 Ga SS 6S Ge £4 OE OF C446 8OS8 
SOM DODee CO DA & 
owe we oe 9 £9 £95 OO 0) me et rt et oe on 


START 


TT OOM wet et xe amt mat emt wt emt re. 
NNNNDOOONMAAANMaAoD 
~a~SA SAQA! A SSS! RSS, 
eroocooocococdcdacoenoe 
OO CE Cees cee et st we wt et et tt ot 
~~~ S'’AA SA A SSS SHH SS 
Ua oft Af0 oF) Un ut af Uf 8 OT oft OU of 
BPE PE PEE Re RE PR 


LOG DATE 


wan 

rr 2 

WN ~~ CO—eo 
mtr Wn 27777 
ld in uf - D2DDD>D™ 
re tole 7 OErrrr2 
<oroe & DUNHAM 
eae ae at ae Oana aad i: 


JoB NAME 
LTIPR 


aN = FN OO mane ON 


ee Lt Bot Lt od) 


JJ 
Volume serial number of LIBIN device (DS1548, in this example) 


Title: LISTING OF $Y$JACNT 
Current system date at the time of UTJAS execution 


Page number 


KOR BOC OGGe 2 OO0O00A 
NANMMAAMAMAAM ATT TTT 


ne ee 8 8 nd es ee i es te et 


©@ © 


IT] 


First heading (at top of page) showing: 


Explanation: 


® ; 
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4.7.4. UTJAS Termination Output 


At the termination of UTJAS, if the $YSJACNT file was defined as LIBIN or LIBOUT for the job step and if no 
unrecoverable error had occurred on the $YSJACNT file, then UTJAS skips to a new page and outputs a heading 
line. Next, the UN98 message is produced: 


UN98 xxxCYL yyyTRK REMAIN ON 2zzzzz SYSJACNT 


where: 
XXX 
Is the number of unused (available) cylinders. 
yyy . 
Is the number of unused (available) tracks. 
ZZZZ2Z 


Ils the volume serial number of the device containing the SYSJACNT file. 


An example of this printout is shown in Figure 4—9. 


@) UNtvAc 906079070 05/4 10400 JOB ACCOUNTING UTILITY 75/12/08 14343 SUPERVISOR YZ 1000! voB 14 CPIS48 


2) UN9B 1 CYL 19 TRK REMAIN ON DS1548 SYSJACNT 


Explanation: 
Ga) Heading tine showing: 


— Machine type 

— Job accounting utility version number 
— System date 

— Time of day 

— Supervisor identification 

— Job number 

— Job name 


@) UN9Q8 message, which indicates the number of unused (availabie) cylinders 
and tracks on the device (volume serial number — in this example, DS1548) 
which contains the $Y$JACNT file 


Figure 4—-9. Example of UTJAS Termination Printer Output 
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CUT 


Comments concerning this manual may be made in the space provided below. Please fill in the requested information. 
System: 
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UP No: Revision No: Update: 
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